Search
K
Policy

Policy Service

0.0.21OAS 3.0

Enterprise level policy service

API Base URL
  • Server 1:https://api.zinnia.io

    api gateway host

Security
Auth0 (openIdConnect)

Policy Search

post
https://api.zinnia.io/policy/v1/policies/search

Query Parameters

sortBystring

field to sort by

sortOrderstring

order to sort (asc or desc)

limitnumber

number of results to limit to

offsetnumber

index to start page search at

Body

application/json

Optional search criteria, none, some, or all criteria can be used. Values cannot be null.

PolicySearchRequest

firstNamestring

policy owner first name

policyNumberstring

number/subjective id of policy. Optionally, you can partial search if SSN is also using partial search (e.g. *1234)

lastNamestring

policy owner last name

fullNamestring

policy owner full name. Optionally support partial search

policyStatusstring

status of policy, needs to be enum

planCodestring

plan code for policy

lastUpdatedstring(date-time)

last time policy was updated

createdAtstring(date-time)

creation time of the policy

ssnstring

Policy owner social security number. SSN should be 9 digits, or the last four (e.g. *1234) when policy number is also last four (partial search)

idstring

reference id of the policy, fully unique

lineOfBusinessstring

line of business to search for, options are LIFE or Annuity Product

partyIdsarray[string]

list of party ids associated with the policy

Example:["4fd32e7aecc24888be9c5418d6dc646a","2739e8897e7141189ccd366f7d054ff0"]

issueDateFromstring(date)

Start date for issue date range query in YYYY-MM-DD format

Example:2024-01-01

issueDateTostring(date)

End date for issue date range query in YYYY-MM-DD format

Example:2024-12-31

Response

application/json

OK

PolicySearchResponse

totalnumberrequired

Example:121

countnumberrequired

Example:1

nextstringrequired

Example:/policy/v1/policies/search?offset=10&limit=10

previousstringrequired

Example:[ "" ]

resultsarray[object]required

array of policy reference data

Show Child Parameters
post/policy/v1/policies/search

Body

{}
 
application/json

Overview

Get policy overview

Policy Versions

get
https://api.zinnia.io/policy/v1/policies/{planCode}/{policyNumber}/versions

Query Parameters

limitinteger
transactionTypestring

Specifies the type of transaction being performed, such as Premium Payment, Loan Repayment, Anniversary etc

Allowed values:ActivationAddOwnerAddressChangeAgentChangeAnnuitantChangeAnniversaryAnnualPolicyRefreshAndRecalculationAssigneeChangeBankAccountChangeBeneficiaryChangeCalendarProcessingCancelNoPremiumClaimPayoutCommunicationPreferenceChangeConversionActivationCostOfInsuranceCoverageChargeCoverageCreditDeathClaimDeliveryDateSetupDisbursementEmailChangeExistingPartyNameChangeExpenseChargeFaceAmountChangeFaceAmountDecreaseFaceAmountIncreaseFeatureChangeForceOutFreeLookExpirationFreeLookCancellationFullSurrenderFundAllocationsChangeFundTransferGrantorChangePaymentInitialPremiumIdentifierChangeInitialPremiumInterestCreditInterestCreditLoanInterestCreditMatchInterestLoanIssuanceLapseLapseAssessmentLoanAnniversaryTrueUpLoanRepaymentOneTimeMatchBonusVestingMultipleBeneficiaryChangeMultipleEmailChangeMultiplePayeeChangeMultipleAgentChangeMultipleOwnerChangeMultipleAnnuitantChangeMultiplePhoneNumberChangeNewLoanNotificationOfDeathClaimOneTimePremiumOwnerChangePartialWithdrawalOneTimePayeeChangePaymentExpirationPaymentLoanRepaymentOneTimePaymentOneTimePremiumPaymentSystematicLoanRepaymentPayorChangePhoneNumberChangeRateRenewalRemoveOwnerRescissionPowerOfAttorneyChangePreferredMailingAddressChangeReinstatementReinstatementApprovedRequiredMinimumDistributionOneTimeSubsequentPaymentSubsequentPremiumSweepSystematicLoanRepaymentSystematicLoanRepaymentSetupSystematicPartialWithdrawalSystematicPartialWithdrawalSetupSystematicRequiredMinimumDistributionSystematicRequiredMinimumDistributionSetupSystematicPaymentSetupSystematicAnnuityPayoutSystematicAnnuityPayoutSetupSystematicProgramUpdateTPDChangeTrusteeChangeUnitExpenseChargeValueAdjustmentYearBeginningRefreshAndRecalculationWithdrawnApplicationDollarCostAverageProcessingDateServiceChargeTransferChargeRiderAdditionAnnuitizationAnnuityBenefitReductionReclassificationFlatExtraChangeCommutationDividendDividendFeatureChargeMarketTimerFeeInterimAnnualProcessingHardshipWithdrawalHardshipEndResetBenefitAmountsGuaranteedAccumulationBenefitPeriodEndGainLossChargeBackSpousalContinuationPeriodicChargeDeathBenefitLockInRatchetLockInGrowthDeathBenefitLockInDateOfDeathBenefitAmountAutoAdjustmentNotificationOfRiderClaimStartLongTermCareBenefitStartStopDailyRatchetAnnuitizationAnniversaryDeclineFeeChangeGuaranteedWithdrawalBenefitPaymentLockInExcessInterestCreditLongTermCareWithdrawalGuaranteedWithdrawalBenefitInterestAdjustmentInvestmentAdvisorFeePayoutAmountChangeAdditionalBenefitStartAdditionalBenefitEndRiderActivationAnniversaryAdditionalBenefitRenewQualifiedPlanChangeAdvanceAnnuityPaymentPartialCommutationGuaranteedIndexRatesBailoutRenewalNonLifeAnnuitizationAdditionalBenefitReCertificationCostBasisReceivedFreeWithdrawalRecalculationYearEndGainLongTermCareCertificationDateQuarterlyProcessingBenefitBaseAdjustmentRiderBenefitBaseLockInGuaranteedDeathBenefitRollUpRenewGuaranteedWithdrawalBenefitRollUpRenewRiderChargeLongTermCareFeeStartStopLongTermCareAssessmentChargeRoleBirthdayPendingUnclaimedPropertyPendingPartialUnclaimedPropertyLiquidatedUnclaimedProperty

Path Parameters

planCodestringrequired
policyNumberstringrequired

Response

application/json

OK

policyNumberstring

The Policy Number is a unique identifier assigned to a life insurance or annuity contract by the insurance carrier. It serves as the official reference number for tracking, managing, and servicing the policy throughout its lifetime

eventstring

The transaction type of the current policy snapshot

timestampstring(date-time)
versioninteger(int32)
get/policy/v1/policies/{planCode}/{policyNumber}/versions
 
application/json